home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / mltplt22.zip / MLTIPLT2.HLP (.txt) < prev    next >
OS/2 Help File  |  1996-07-08  |  30KB  |  800 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. WELCOME ΓòÉΓòÉΓòÉ
  3.  
  4. WELCOME TO MULTIPLOT/2 v1.2
  5. ---------------------------
  6. by
  7. Mike Stott
  8. NeoDym Systems
  9. 15 Nesbitt St
  10. Nepean
  11. Ontario
  12. Canada K2H 8C4
  13. July 1996
  14.  
  15. Select from the following 
  16.  
  17. o Quick Start 
  18.  
  19. o What is Multiplot/2? 
  20.  
  21. o How to Use Multiplot/2 
  22.  
  23. o Intermediate Level 
  24.  
  25. o Advanced Level 
  26.  
  27. o Contacting NeoDym 
  28.  
  29. o Copyright Notice 
  30.  
  31. o Registration 
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ 2. QUICK START ΓòÉΓòÉΓòÉ
  35.  
  36.  Copy the MLTPLT22.ZIP distribution file into a convenient directory on your 
  37. hard drive.  Decompress the MLTPLT22.ZIP distribution file using PKUNZIP (DOS) 
  38. or UNZIP (OS2).  Get an OS/2 command prompt by opening an OS/2 window and 
  39. change to the directory containing MULTIPLOT2.  Now just type 
  40.  
  41. TRYITNOW 
  42.  
  43. MULTIPLOT2 should now start and open up a PM window on the desktop and show a 
  44. plot of the data sets in the sample1.dat file. 
  45.  
  46. Read the following documentation and enjoy using MULTIPLOT2. 
  47.  
  48. Find out more about MULTIPLOT/2 
  49.  
  50. Move to how to use MULTIPLOT/2 
  51.  
  52.  
  53. ΓòÉΓòÉΓòÉ 3. WHAT IS MULTIPLOT/2? ΓòÉΓòÉΓòÉ
  54.  
  55.  Multiplot/2 is a versatile, easy to use OS/2 2.X 32 bit Presentation Manager 
  56. application for manipulation and plotting of technical data sets and generation 
  57. of publication quality scientific and technical line graphs.  On the same chart 
  58. it can plot many sets of data to the same scale and in a variety of 
  59. formats,selectable by simple menu 'click'.  The data in an individual data set 
  60. can consist of any number of points (greater than zero) and the points can be 
  61. at arbitrary, non-uniformly spaced intervals on the x axis.It isn't necessary 
  62. to tell Multiplot/s how many items are in the data set.  It will count them for 
  63. you.  Each line can be automatically plotted in a different colour and line 
  64. type (i.e.  dotted, dashed etc) or fixed as solid and black. 
  65.  
  66. The data can be replotted in many different combinations of linear, 
  67. logarithmic, deciBel or polar by simple menu command. 
  68.  
  69. The charts are automatically scaled to accomodate the maximum range of x and y 
  70. values in the data sets.  Scaling is 'sensible' and in a 1-2-5 sequence with a 
  71. menu choice for manual override.  If you want to force a larger scale 
  72. automatically, just include two extra data sets in your data file, each with a 
  73. single point in it.  These points should be the bottom left corner and the top 
  74. right corner of the chart you want. 
  75.  
  76. Axis labels and plot title are entered via the data file containing the 
  77. numerical data.  Annotations can be added via the data file or manually and 
  78. moved or re-sized in WYSIWYG fashion using the mouse. 
  79.  
  80. The plotted chart is displayed in an OS/2 PM window which can be resized or 
  81. reshaped using the mouse in the normal way. 
  82.  
  83. Menu choices are presented in the diplay window to enable the user to direct 
  84. how the program interpolates between the data points. Available choices (v1.0) 
  85. are straight line,'low-pass' smoothing, cubic spline and no interpolation i.e. 
  86. only the points are plotted with no lines in between. 
  87.  
  88. The displayed chart can be copied via the clipboard to a suitable PM DTP or 
  89. word processing program from which the chart can be incorporated into documents 
  90. and printed.  The copying can be made as an os/2 metafile or as a bitmap. 
  91. Metafile is best as it enables the chart to be resized without loss of quality. 
  92. Unfortunately os/2 and MS Windows metafiles are different and so this method 
  93. can only be used with suitably equipped os/2 Presentation Manager programs. 
  94. The OS/2 'Picture Viewer' is a simple way to display the metafile and print the 
  95. result on the default printer. It can usually be found at 
  96. \OS2\APPS\PICVIEW.EXE. 
  97.  
  98. Charts copied to the clipboard in bitmap form can be pasted into os/2 PM or MS 
  99. Windows programs.  Note that bitmaps exported from MULTIPLOT/2 are copies of 
  100. the display window and so reflect any resizing or reshaping made to the window. 
  101. Metafiles are device independent and so do not resize or reshape with display 
  102. window changes. Graphs can also be saved to disk files both in metafile or 
  103. bitmap form. 
  104.  
  105. Multiplot/2 has a lot of flexibility in reading and modifying data organised in 
  106. different ways.  For example in 'column' or 'row' format and with one or 
  107. several 'Y' sequences corresponding to a single 'X' sequence.  It can also read 
  108. data which is expressed in a recycling or modulus fashion, such as day numbers 
  109. in the week or week numbers in the year. 
  110.  
  111. In addition the program can be made to "filter" (i.e.  plot or not plot) a 
  112. point depending on the value of the same or some other point.  Using this 
  113. facility you can selectively plot points which satisfy some separate criteria. 
  114.  
  115. You can also add a value to the X and/or Y data so as to offset it and plot it 
  116. 'modulo' an arbitrary value. The new data thus created can be saved to disk in 
  117. 'row' or 'column' format, thereby giving you the ability to transpose your data 
  118. using Multiplot/2. 
  119.  
  120. For users who want automated data generation and plotting environments, 
  121. Multiplot/2 now has an extensive command line control capability.  Most 
  122. features can be controlled from the comand line, including the ability to store 
  123. the images to disk and to terminate automatically without asking for user input 
  124. when finished.  This is most useful in automated unattended data generation 
  125. situations where, for example, you want to run a series of programs overnight 
  126. and look at the graph results next day. 
  127.  
  128.  
  129. ΓòÉΓòÉΓòÉ 4. HOW TO USE MULTIPLOT/2 ΓòÉΓòÉΓòÉ
  130.  
  131. Multiplot/2 has many levels of sophistication in its operation and many methods 
  132. of controlling the operation of the program. The guide is divided into 3 parts. 
  133.  
  134.  1. Simple Operation 
  135.  
  136.  2. Intermediate Operation 
  137.  
  138.  3. Advanced Operation 
  139.  
  140.  
  141. ΓòÉΓòÉΓòÉ 4.1. SIMPLE OPERATION ΓòÉΓòÉΓòÉ
  142.  
  143. The easiest way to run the program is to launch from the Work Place Shell. 
  144. Just display the MULTIPLOT/2 icon (for example by navigating to the directory 
  145. in which Multiplot/2 is located using the PM 'Drives' object) and double click 
  146. on it.  You can also launch from an OS/2 command line. Navigate to the correct 
  147. directory using the normal and type MLTIPLT2.  A file dialog window will pop up 
  148. to enable you to select a data file for plotting.  Several example data files 
  149. are included as examples. The menu bar presents many choices for controlling 
  150. the nature and appearance of the plot 
  151.  
  152. To make your own data files, arrange your data in an ASCII text file in column 
  153. format as shown below with the X and Y values on the same line, separated by 
  154. spaces or tabs. 
  155.  
  156. x   y
  157. x   y
  158. x   y
  159. |   |
  160. |   |
  161. ***
  162. x   y
  163. x   y
  164. x   y
  165. |   |
  166. |   |
  167. ***
  168. "X-axis label"
  169. "Y-axis label"
  170. "Plot Title"
  171. ###
  172.  
  173. Each group or set of X-Y pairs results in one line on the final plot chart. 
  174. You can have up to 800 points per line and up to 60 lines on the plot.  You 
  175. don't have to have the same number of points in each line and you don't have to 
  176. make the points uniformly spaced along the x axis. 
  177.  
  178. If you have a situation where you have several y values all corresponding to 
  179. the same sequence of x values, you don't have to keep putting in the same x 
  180. values over again.  You can instead put them in like this 
  181.  
  182. X    y1    y2    Y3   -    -
  183. X     y1    y2    Y3   -    -
  184. |     |    |    |
  185. |     |    |    |
  186. ***
  187. "X-axis label"
  188. "Y-axis label"
  189. "Plot Title"
  190. ###
  191.  
  192. Sometimes you get a situation where your data is arranged in
  193. rows rather than in columns.  In mathematical terms it is
  194. "transposed" -a term borrowed from matrix operations.  In
  195. this case we get all the X values on one line and all the Y
  196. values on the next line.  We have to tell Multiplot/2 that
  197. the data is organized in this way.  This is done by putting
  198. the keyword xytransposed before the data.  For example
  199.  
  200. xytransposed
  201. x     x    x    x    x
  202. y     y    y    y    y
  203. |     |    |    |    |
  204. |     |    |    |    |
  205. ***
  206. |||
  207. ***
  208. "X-axis label"
  209. "Y-axis label"
  210. "Plot Title"
  211. ###
  212.  
  213. Similarly to the column situation we can have several sets of y's corresponding 
  214. to the same set of x's.  For example 
  215.  
  216. xytransposed
  217. x     x    x    x
  218. Y1    Y1